home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / amok98-106 / amok105 / muireicon / doc / english / muireicon.doc next >
Text File  |  1994-05-05  |  35KB  |  1,087 lines

  1.  
  2.  
  3.  
  4.  
  5.                          M u i R e I c o n   V2.21
  6.  
  7.                             © by Stefan Schulz
  8.  
  9.                                 in 1993/94
  10.  
  11.                                = MAILWARE =
  12.  
  13.  
  14.  
  15.                                  Contents
  16.                                  --------
  17.  
  18.      1. What's it about...
  19.      1.1  Description                  That's it for
  20.      1.2  Requirements                 All you need is...
  21.         
  22.      2. Well, let's start...
  23.      2.1  Installation                 First install it :o)
  24.      2.2  Startup                      But now...
  25.      2.3  Usage                        Tell me how to...
  26.         
  27.      3. Oh, yes. The justice Side...
  28.      3.1  Copyright                    It's MINE!! ;o)
  29.      3.2  Redistribution               Spread...how?
  30.      3.3  Disclaimer                   Liable? Me? Never!
  31.      3.4  MUI                          about MUI
  32.         
  33.      4. Want more...?
  34.      4.1  History                      How did it start?
  35.      4.2  Acknowledgments              Many, many thanks!
  36.      4.3  Updates                      Where to get?
  37.      4.4  Support                      Author, who are you?
  38.         
  39.         
  40.  
  41.  
  42. 1.1 Description
  43.     ------------
  44.  
  45.   Well,  what  shall  this  program  do?   It's  for changing the values of
  46. Icons...   hm,  but  there's  a  Standardfunction  for this, isn't it?  The
  47. Information-Function  of  the  Workbench,  no?  Yes, maybe, but this is not
  48. just  a  program for loading an Icon, changing Values and save it, but much
  49. more.  It's for easily collecting Values out of various Icons and give them
  50. to all the Icons which should get them.
  51.  
  52.   For example if you want a couple of Icons to have the same Image (because
  53. they  are  e.g.  the same kind of Texts, and every Icon is different to the
  54. other).   Or  you  want  to  change  the view of a drawer to the "hypercool
  55. 8-Color"-Icon,  without  having  to  place  all  the drawers and resize the
  56. windows  they  open after you copied and renamed the new Icon.  That's much
  57. more simple to do with MuiReIcon.
  58.  
  59.   Or  do  you  wanto to change the DefaultTool of Project-Files (eg.  Texts
  60. and  Scripts) so that, if you activate their Icons, they all shall be shown
  61. by  your  new  Text-Viewer "DH7:Textviewingprograms/ShowTextwithfastScroll"
  62. (well),  so  you  can  either start Information with each of this Icons and
  63. enter  the name of this programm, or type it once, and clone and rename the
  64. Icon  as  often  as you need it.  Or you can use MuiReIcon, which gives you
  65. the feel of much more comfort.
  66.  
  67.   Also  old  or  not  yet  inserted  ToolTypes and even the kind of an Icon
  68. (Drawer,  Project, Program) easily can be changed.  All this changes can be
  69. done   comfortable   and   easy   using  MuiReIcon,  without  blocking  the
  70. multitasking of the Workbench, like "Information" does.
  71.  
  72.  
  73.  
  74. 1.2 Requirements
  75.     ------------
  76.  
  77.   For   getting  the  program  running  you  have  to  have  the  following
  78. Requirements:
  79.  
  80. o  You need an Amiga ;o)
  81.  
  82. o You're using at least AmigaDOS 2.0 onyour System, whereby using Workbench
  83. 2.0  you can only use the english version.  Since Workbench 2.1 the program
  84. uses  the  locale.library for you being able to read the text in your local
  85. language, if the catalog for your language is installed, of course (for now
  86. there's just German).
  87.  
  88. o You need to have the muimaster.library (version 2.0 or higher.  It is not
  89. spread  with  this  package,  but it's worth of getting the MUI-Package.
  90.  
  91.  
  92.  
  93.  
  94. 2.1 Installation
  95.     ------------
  96.  
  97.   Installation is only necessary, if MUI isn't installed yet.  In this case
  98. you have to get at least the MUI-Userpackage and install it on your System.
  99.   Do  you  want to use the program in your local language, copy the catalog
  100. included  in  this  package to the LOCALE:Catalogs directory.  The build-in
  101. language is english.
  102.   If you've written a catalog for another language, please send it to me.
  103.  
  104.  
  105.  
  106.  
  107. 2.2 Startup
  108.     -------
  109.  
  110.   You can run the program either via Workbench as usual with a double-click
  111. onthe  Programicon or via CLI.  In both cases a window should appear.  It's
  112. not  very  senseful  to  start  MuiReIcon if there's Workbench or a similar
  113. Program.
  114.   For now just some ToolTypes are supported.  Arguments given by CLI wil be
  115. ignored.
  116.   It will pass a little time, before the window appears, because first some
  117. structures  have to be initialized and all used libraries have to be loaded
  118. into memory, so be patient.  The Startuptime depends on your System.
  119.  
  120.  
  121.  
  122. 2.2.1 ToolTypes
  123.       ---------
  124.  
  125.   Yet,  there  are  5  supported  ToolTypes.  They are used for setting the
  126. values  for  the  options  given by the program, so you don't have to reset
  127. this values each time you start the program.
  128.   These Tooltypes are:
  129.   
  130.   a) IMAGEONLY        - Option Image Only
  131.  
  132.   b) DROPACTIVE       - Option Drop-Activation
  133.   
  134.   c) SAVEWB39         - Option Save WB 3.x-Icons
  135.   
  136.   d) NOICONPOS        - Option No Icon-Position
  137.   
  138.   e) SAVEINFO         - Option Save Information
  139.  
  140.   Example:
  141.   
  142.   IMAGEONLY=YES  means,  the  Menu-Item  will  be  checked immediatly after
  143.   startup.
  144.  
  145.  
  146.  
  147. 2.3 Usage
  148.     -----
  149.  
  150.   MuiReIcon uses a GUI, i.e.  Graphic User Interface.  Nearly every command
  151. can  be done both with mouse and Keyboard.  Shortcuts for specific commands
  152. are displayed by an underlined letter inside the switches.
  153.   There  are  a  couple  of  switches in this window.  Let's start with the
  154. standard ones:
  155.  
  156.   2.3.1     System-Gadgets             The Switches in the border
  157.  
  158.   The Window itself is splitted in some Groups:
  159.   
  160.   2.3.2.1   Mode                       Choosing workingmode
  161.   2.3.2.2   ToolTypes                  List of the ToolTypes
  162.   2.3.2.3   ColorSwap                  For the nice look
  163.   2.3.2.4   Information                Additional Infos
  164.   2.3.2.5   Source & Destination       Put Icons here
  165.   
  166.   Furthermore there is the menu:
  167.   
  168.   2.3.3.1   Project                    Infos and Goodbye
  169.   2.3.3.2   Options                    How would you like it?
  170.   2.3.3.3   Color Presets              The usual Colorsets
  171.  
  172.   Without Gadgets:
  173.   
  174.   2.3.4     ARexx                      Remote-Control
  175.  
  176.   If something goes wrong:
  177.   
  178.   2.3.5     Errors                     Wrong Arguments and more
  179.  
  180.  
  181.  
  182. 2.3.1 System-Gadgets
  183.       --------------
  184.  
  185.   In  the Borders of the window there are the usual gadgets you can find in
  186. nearly  every  application.   First  there  are the close-, the depth-, the
  187. 2-Sizes-  and,  at right-bottom, the Sizing-Gadget.  Additionaly there's an
  188. Iconify-Gadget  for  iconify the window.  Using this button the window will
  189. disappear  and  an  AppIcon will appear on the root of the workbench.  Like
  190. using the Source & Destination Fields you can place Icons on it, which will
  191. be treated owing to the actual Mode.
  192.  
  193.  
  194.  
  195. 2.3.2 Mode
  196.       ----
  197.  
  198.   This  Group consists of 6 Subgroups, which are separated by a line.  Here
  199. you  select the attributes, which will be overtook by the Destinationicons.
  200. Moreover  here  will be set the values for Kind, Default Tool and Stacksize
  201. of  the Icon.  All modes can be combined in any order.  Some modes will not
  202. fit  to  Icons  owing  to  its  kind.  In this case the Checkbutton will be
  203. displayed shadowed.
  204.   If  no  Mode  is activated and the window is iconified placing an Icon at
  205. the  AppIcon  of  the  program  will  be  treated  like  placing  it at the
  206. SourceIcon-Field.   By  at least one active mode this Icon will be used for
  207. Destination.
  208.  
  209.   2.3.2.1.1  Kind             
  210.   2.3.2.1.2  Default Tool     
  211.   2.3.2.1.3  Tool Types       
  212.   2.3.2.1.4  Image            
  213.   2.3.2.1.5  ColorSwap        
  214.   2.3.2.1.6  Stack            
  215.  
  216.  
  217.  
  218. 2.3.2.1.1 Kind
  219.           ----
  220.  
  221.   Every  Icon shall be transformed into an Icon of the selected Kind.  This
  222. will influent the modes you can choose.
  223.   The  cycle-gadget  is  for  choosing  the Kind of Icon to be used for the
  224. Destination-Icon.    It  can  be  set  through  dropping  an  Icon  at  the
  225. Sourcefield or at this subgroup itself.
  226.  
  227.   There are six Kinds of Icons recognized by MuiReIcon:
  228.   
  229.   a) Disk         - Icons of Floppy, Hard Disks etc.
  230.   b) Drawer       - Directory-Icons
  231.   c) Tool         - Icons of executable programs
  232.   d) Project      - Project-Icons (e.g. scripts, texts etc.)
  233.   e) Trashcan     - The trashcan-Icon
  234.   f) Kick/NDOS    - Default-Icon  for  Disks which Filesystem is not known.
  235.                     This   Kind   is   only   availabe   in  the  menu-item
  236.                     Save as default... .
  237.   
  238.  
  239.  
  240. 2.3.2.1.2 Default Tool
  241.           ------------
  242.  
  243.   The  text  inside  the  String-Gadget  is  placed for default tool of the
  244. Destination-Icon.   Only  Disk- and Projec-Icons do have a default tool, so
  245. only one of these kinds will get this text.
  246.   For setting the default tool of an Icon, there is a String-Field in this
  247. group. It can be set free using the keyboard or dropping an Icon on this
  248. field or the Source-Field.
  249.   For example for Text-File-Icons here should be inserted the program which
  250. shall be used for displaying the text. Or analog for pictures and so on.
  251.           
  252.  
  253.  
  254. 2.3.2.1.3 Tool Types
  255.           ----------
  256.  
  257.   All  actual  in  the  ToolType-List  displayed ToolTypes are given to the
  258. Destination-Icon.    Tooltypes   only  exist  for  Project-,  Program-  and
  259. Drawer-Icons.
  260.           
  261.  
  262.  
  263. 2.3.2.1.4 Image
  264.           -----
  265.  
  266.   The  Image  given  by  the  Source-Icon  will  also  be  placed  for  the
  267. Destination-Icon.    Even   the   attributes   of  the  picture  (like  its
  268. selection-mode) will be used.  Every Icon does have a picture.
  269.           
  270.  
  271.  
  272. 2.3.2.1.5 ColorSwap
  273.         ---------
  274.  
  275.   The Values of each Color-Register is able to be replaced by an other one.
  276. Which   Registers  are  replaced  with  others  can  be  chosen  using  the
  277. ColorSwap-List.
  278.  
  279.  
  280.  
  281. 2.3.2.1.6 Stack
  282.           -----
  283.  
  284.   The  stacksize  which belongs to the program the icon ows to will be used
  285. in  Destinationicons.   The  size  of  the  Stack  can  be  set  using  the
  286. String-Gadget or dropping an Icon at the Sourcefield or the subgroup.
  287.  
  288.  
  289.  
  290. 2.3.2.2 ToolTypes
  291.         ---------
  292.  
  293.   Owing  to  the  setting  of  MUI  this  group  can  be  selected  using a
  294. cycle-gadget  or  like  register-cards.  Both can be used to switch between
  295. ToolType-List, ColorSwap-List and the additional Informations.
  296.   Here  all  the actual ToolTypes are displayed and can be changed.  If the
  297. mode ToolTypes is set, the Destination-Icon will get all this ToolTypes.
  298.  
  299.   The  ToolTypes  of  an  Icon  are  read  out  of  an  Icon  placed at the
  300. Source-Field or the ToolType-Field itself.
  301.  
  302.   For  Changing  the  entries there are beside the list nine switches and a
  303. String-Gadget.   You  can  select  an entry by simply choosing the ToolType
  304. with your left mouse-button, as usual.
  305.   The following Gadgets are placed here:
  306.  
  307.   2.3.2.2.1  Proportional and Arrows 
  308.   2.3.2.2.2  Modification-Buttons    
  309.   2.3.2.2.3  Ordering-Buttons        
  310.   
  311.   And finally the
  312.   
  313.   2.3.2.2.4  String-Gadget           
  314.  
  315.  
  316.  
  317. 2.3.2.2.1 Proportional and Arrows
  318.         -----------------------
  319.  
  320.   Sometimes the display is not big enough for showing all the Tooltypes at
  321. once. Using the proportional-gadget and the arrows the displayed part of
  322. the list can be moved up and down.
  323.   
  324.  
  325.  
  326. 2.3.2.2.2 Modification-Buttons
  327.           --------------------
  328.  
  329.  a) New:          
  330.                   A  new  ToolType  will be inserted at the actual position
  331.                   and set active.  You can immidiatly edit it.
  332.  
  333.  b) Clone:        The  actual  ToolType will be copied so you have it twice
  334.                   in the List.
  335.  
  336.  c) Remove:       Removes the actual ToolType out of the list.
  337.  
  338.  d) De-/Activate: A   ToolType   is  "deactivated",  if  it's  enclosed  by
  339.                   brackets.   Using this switch, enclosing brackets will be
  340.                   removed  (activating)  or set (deactivating) owing to the
  341.                   actual state of the tooltype.
  342.           
  343.  
  344.  
  345. 2.3.5.5 Ordering-Buttons
  346.         ----------------
  347.   
  348.   a) Top:    Move Tooltype to the top of the list.
  349.           
  350.   b) Bottom: Move Tooltype to the Bottom of the list.
  351.           
  352.   c) Up:     Move Tooltype one place above the actual.
  353.           
  354.   d) Down:   Move Tooltype one place under the actual.
  355.   
  356.   e) Sort:   Sort the Tooltype-List in alphabetical order.
  357.           
  358.  
  359.  
  360. 2.3.2.2.4 String-Gadget
  361.           -------------
  362.  
  363.   Here you can edit a ToolType. Using the Cursor-Keys you can move up and
  364. down in the ToolType-List for editing other Entries.
  365.  
  366.  
  367.  
  368. 2.3.2.3 ColorSwap
  369.         ---------
  370.  
  371.   Owing  to  the  setting  of  MUI  this  group  can  be  selected  using a
  372. cycle-gadget  or  like  register-cards.  Both can be used to switch between
  373. ToolType-List, ColorSwap-List and additional Informations.
  374.   For changing a Color-Register to an other value you have to choose the
  375. Register to be changed out ofthe list looking like this:
  376.  
  377.         Register 0 => 0
  378.         Register 1 => 1
  379.         Register 2 => 2
  380.                :
  381.                :
  382.  
  383.   Using the horizontal Proportional-Gadget you can change the resulting
  384. Register. For example for exchanging Register 1 and 2 the list should look
  385. like the following:
  386.  
  387.         Register 0 => 0
  388.         Register 1 => 2
  389.         Register 2 => 1
  390.                :
  391.                :
  392.  
  393.   Some  preset  Settings  can  be  chosen  using  the menu Color Presets by
  394. selecting  one  of the menu-points.  The list will be refreshed immediately
  395. and displays the new Setting.
  396.  
  397.   Furthermore there are three buttons:
  398.  
  399.   2.3.2.3.1  Last Bank 
  400.   2.3.2.3.2  Test      
  401.   2.3.2.3.3  Original  
  402.   
  403.  
  404.  
  405. 2.3.6.1 Last Bank
  406.         ---------
  407.  
  408.   Using  this switch the register will be reset to the setting used before.
  409. The  actual  setting  will be backed up and you can recall it by activating
  410. this button again.
  411.  
  412.  
  413.  
  414. 2.3.6.2 Test
  415.         ----
  416.  
  417.   This  button  will  operate  on the colors of the actual Source-Icon, the
  418. registers  of  it will be changed as selected in list.  The new look of the
  419. image  will  be displayed in the Source-Field.  This does not really affect
  420. the  Icon-Image,  but  is  a  test-view.   To use the swapped image in your
  421. Destinationicons you have to set the owing Mode.
  422.  
  423.  
  424.  
  425. 2.3.2.3.3 Original
  426.           --------
  427.  
  428.   The   actual   valid   image   which  will  be  used  by  saving  or  for
  429. Destinationicons  will be redisplayed in the Source-Field.  This is useful,
  430. if you did a test and didn't get the wished result.
  431.  
  432.  
  433.  
  434. 2.3.2.4 Information
  435.         -----------
  436.  
  437.   Owing  to  the  setting  of  MUI  this  group  can  be  selected  using a
  438. cycle-gadget  or  like  register-cards.  Both can be used to switch between
  439. ToolType-List, ColorSwap-List and additional Informations.
  440.   This  Group  is  used  for show respectively setting the usual additional
  441. Information,  which do not belong to the Icon itself, but the File the Icon
  442. ows to.
  443.   The Date of last changings is _not_ changeable.
  444.   All  here  shown  attributes  will just be used by saving an Icon via the
  445. menu-items  Save Icon  and Save Icon as...  .  If there is no File owing to
  446. the  Icon  (respectively no directory), the values will be set for the Icon
  447. itself.
  448.  
  449.   Yet, the following attributes may be set:
  450.   
  451.   2.3.2.4.1  Protection-Bits 
  452.   2.3.2.4.2  Comment           
  453.  
  454.  
  455.  
  456. 2.3.2.4.1 Protection-Bits
  457.           ---------------
  458.  
  459.   Here  you  can  select  the kinds of protection for the File owing to the
  460. Icon.   They  will  automatically  be  set  by entering a Sourceicon.  Each
  461. Protection-bit  can  be  set  via checking it.  The are active, if they are
  462. chacked, else inactive.
  463.   You can distinguish between two groups, which are displayed here in two
  464. by a line seperated columns.
  465.  
  466.   a) User-dependend Bits
  467.  
  468.      These  Bits  define  whether  the  file  shall be writeable, readable,
  469.    deleteable or executeable.  Every combination is possible.  According to
  470.    the   Documentation  AmigaDOS  supports  different  protectionmodes  for
  471.    different  usergroups  like  known  in  IX-Systems.   Hereby  the system
  472.    distinguishes  between  the  owner  of a file, the group which the owner
  473.    belongs  to,  and all the other users.  On simple use of your Amiga only
  474.    the  owners  bits  will  be  checked by the system.  But using a net- or
  475.    multi-user-system all other bits are used.
  476.      You  can  use  the Cyclegadget to choose the usergroup you want to set
  477.    the protection for.
  478.      
  479.   b) General Bits
  480.   
  481.      These  Bits  are  valid  for  every user.  They define, whether a file
  482.    shall be hidden, or whether it is a script, i.e.  a sequence of commands
  483.    in form of a textfile.
  484.      Furthermore there is a bit for defining, whether this program is pure,
  485.    which  is  to  be  kept  resident  in  memory (like libraries are).  And
  486.    finally  the archive-bit, which is often used by Backup-Programs to show
  487.    whether a file was archived.
  488.  
  489.  
  490.  
  491. 2.3.2.4.2 Comment
  492.           -------
  493.  
  494.   The  Stringgadget  here shows the actual text of the comment owing to the
  495. file.  It is editable and will be written by saving the icon.
  496.  
  497.  
  498.  
  499. 2.3.7 Source & Destination
  500.       --------------------
  501.  
  502.   Both framed Fields, superscribed with Source and Destination, are used as
  503. input-fields  for  arguments.   For  choosing a Source-icon just select the
  504. Icon  to be used without releasing the button move it over the Source-Field
  505. and  drop it here.  The Image of the SourceIcon will be displayed as far as
  506. it  fits  inside  the  frame.   The  size  of  the  frames  depend  on  the
  507. window-size.
  508.   Since AmigaOS 2.0 the Workbench can display files which don't have Icons.
  509. In this case, the Defaulticon for this file will be loaded and treaten like
  510. the file having an own Icon.
  511.  
  512.   In   the   same   way   you   chose   the  Source-Icon,  you  can  select
  513. Destination-Icons, but you can select more than just one Icon.  Just select
  514. all  the Icons while pressing the shift-key, hold down the mousebutton when
  515. selecting  the  last one, move the mouse-pointer over the Destination-Field
  516. and  release the button.  The will be treated as if you placed each Icon on
  517. its own at the Destination.
  518.  
  519.   Take  care  of the mouse-pointer has to be placed over the Field the Icon
  520. should  go  as  argument  to.   If  you  place  a  couple  of  Icons at the
  521. Source-Field only the first will be used and all the others ignored.
  522.  
  523.   The program decides for every Destination-Icon, if the Values selected by
  524. the mode fit to the Kind of the Icon and treats them owing to the kind.  If
  525. a  value  cannot  be  placed  because  it  does  not  fit  there will be NO
  526. Error-request!
  527.   If  you  drop  a  file  onto  the  Destinationfield which does not have a
  528. physical  Icon,  a  new  Icon  will  be  created for the file which has the
  529. attributes  of  the  Defaulticon  for this file and the attributes selected
  530. using the program as known.
  531.  
  532.  
  533.  
  534. 2.3.8 Project
  535.       -------
  536.  
  537.   Yet, this menu contains six items:
  538.  
  539.         - Open Icon...
  540.           Shortcut: Amiga-o
  541.           
  542.           A  File-Requester  will be opened, for you selecting the filename
  543.           of the icon which should be loaded as Source-Icon.
  544.         
  545.         - Save Icon
  546.           Shortcut: Amiga-s
  547.           
  548.           The actual Values will be saved together to the Icon.
  549.         
  550.         - Save Icon as...
  551.           Shortcut: Amiga-a
  552.           
  553.           Choose  the Filename and -path using a File-Requester, which will
  554.           be  used  for  saving  the Icon.  Take care NOT to add the suffix
  555.           .info!
  556.  
  557.         - Save as default
  558.           Shortcut: (none)
  559.           
  560.           This  menu-item contains a submenu, where the kind of Defaulticon
  561.           is  to  be selected.  A so saved Icon will from now on be used as
  562.           Icon for files of the specified kind which do not own an Icon.
  563.           The option No IconPosition will be used automatically!
  564.  
  565.         - About
  566.           Shortcut: Amiga-?
  567.           
  568.           A  Requester  appears  with  Informations  about  Copyrights  and
  569.           Version of the program.
  570.  
  571.         - Quit
  572.           Shortcut: Amiga-q
  573.           
  574.           Causes to end the program like using the Close-Gadget.
  575.  
  576.  
  577.  
  578. 2.3.3.2 Options
  579.         -------
  580.  
  581.   This menu contains the following six items:
  582.  
  583.   2.3.3.2.1  Image Only        
  584.   2.3.3.2.2  Drop-Activation   
  585.   2.3.3.2.3  Save WB 3.x-Icons 
  586.   2.3.3.2.4  No Icon-Position  
  587.   2.3.3.2.5  Save Information  
  588.   2.3.3.2.6  Load Optionen     
  589.   2.3.3.2.7  Save Optionen     
  590.  
  591.  
  592.  
  593.  
  594. 2.3.3.2.1 Image Only
  595.           --------
  596.  
  597.   Shortcut: Amiga-1
  598.   
  599.   Dropping  an  Icon  at  the  Source-Field  by activated Image Only-Switch
  600. (Checkmark  beside  the text) causes loading the image of the Icon only but
  601. not all the other values.
  602.  
  603.  
  604.  
  605. 2.3.3.2.2 Drop-Activation
  606.           ---------------
  607.  
  608.   Shortcut: Amiga-2
  609.   
  610.   If  you  drop  an Icon at the iconified Window will pop-up the window and
  611. set  it  to  active.   Also if you drop an Icon into the window, the window
  612. will automatically set to active.
  613.           
  614.  
  615.  
  616. 2.3.3.2.3 Save WB 3.x-Icons
  617.           -----------------
  618.  
  619.   Shortcut: Amiga-3
  620.   
  621.   The  Icons  will  be  saved  using the since OS 3.0 used 8-Bit-Format for
  622. Icons.  In case of deactivated option, all Icons which consist of more than
  623. 16 colours will be saved as 8-Color-Icons!
  624.  
  625.  
  626.  
  627. 2.3.9.4 No Icon-Position
  628.         ----------------
  629.  
  630.   Shortcut: Amiga-4
  631.   
  632.   The  preset  Position of an Icon will be freed, that is if you don't want
  633. to keep the old position of an Icon.
  634.   This Option will automatically be used for Defaulticons!
  635.  
  636.  
  637.  
  638. 2.3.3.2.5 Save Information
  639.           ----------------
  640.  
  641.   Shortcut: Amiga-5
  642.   
  643.   If  this  item  is  selected,  the additional Informations owing the file
  644. which belongs to the Icon will be saved.
  645.   Attention:  Attributes of the file will be changed, not only of the icon!
  646.   
  647.  
  648.  
  649. 2.3.3.2.6 Load Optionen
  650.           -------------
  651.  
  652.   Shortcut: (none)
  653.  
  654.   The Tooltypes of the Programicon will be loaded and the Options"LINK Usage_Options} will be
  655. set to this values. 
  656.  
  657.  
  658.  
  659.  
  660. 2.3.3.2.7 Save Options
  661.           ------------
  662.  
  663.   Shortcut: (none)
  664.  
  665.   The  actual set Options will be written to the Program-Icon as Tooltypes,
  666. so  the  settings  will  be  the same right after starting the program next
  667. time.
  668.  
  669.  
  670.  
  671. 2.3.3.3 Color Presets
  672.         -------------
  673.  
  674.         - No Swap
  675.           Shortcut: Amiga-1
  676.           
  677.           Every register will be set to itself (identity-function).
  678.           
  679.         - WB 1.x <-> WB 2.x
  680.           Shortcut: Amiga-2
  681.           
  682.           This  setting is for invert Icons, that is, the registers will be
  683.           set the way, so you can swap old WB 1.x-Icons to WB 2-x.
  684.  
  685.  
  686.  
  687. 2.3.4 ARexx
  688.       -----
  689.  
  690.   Some of the functions of this program can be used via an ARexx-Interface.
  691. The functionality of ARexx can be read in the ARexx-Documentations.
  692.  
  693.   Yet, there are the following commands implemented (MUIs standard-commands
  694. excluded):
  695.  
  696.   2.3.4.1  source (and parts)      This should be my source
  697.   2.3.4.2  dest                    Work on this icon
  698.   2.3.4.3  mode                    Set the mode
  699.   2.3.4.4  option                  Options select
  700.   2.3.4.5  register                These registers, please
  701.  
  702.  
  703.  
  704. 2.3.4.1 source (and parts)
  705.         ------------------
  706.  
  707.   Format:               SOURCE <Sourcefile>
  708.   Commandtemplate:      SOURCEFILE/A
  709.   Function:             Select file as Source
  710.   Description:          The named file will be treaten like loading an Icon
  711.                         via the menu-item Open Icon.
  712.  
  713.   Analogue  attributes  of  an Icon can be loaded.  Format and Template are
  714. identical to the one of SOURCE.
  715.   The commands are:
  716.   
  717.   a) KIND       - Take the kind of the icon
  718.   b) DEFTOOL    - Use the default tool of the named icon
  719.   c) TOOLTYPES  - Set the Tooltypes of the icon to the list
  720.   d) IMAGE      - Only take the image of the icon
  721.   e) STACK      - Take the stacksize used in the named icon
  722.  
  723.  
  724.  
  725. 2.3.4.2 dest
  726.         ----
  727.  
  728.   Format:               DEST <Destfile>
  729.   Commandtemplate:      DESTFILE/A
  730.   Function:             Use the named file as Destinationicon
  731.   Description:          The  named  file  will be treaten like dropping the
  732.                         icon at the Destinationfield.
  733.  
  734.  
  735.  
  736. 2.3.4.3 mode
  737.         ----
  738.  
  739.   Format:               MODE KIND|DEFTOOL|TOOLTYPES|IMAGE|COLORSWAP|STACK
  740.                         ON|OFF
  741.   Commandtemplate:      KIND/S,DEFTOOL/S,TOOLTYPES/S,IMAGE/S,COLORSWAP/S,
  742.                         STACK/S,ON/S
  743.   Function:             Switch Mode on or off
  744.   Description:          The named mode will be switched to on if the switch
  745.                         ON is set.
  746.  
  747.  
  748.  
  749. 2.3.4.4 option
  750.         ------
  751.  
  752.   Format:               OPTION IMAGEONLY|DROPACTIVE|SAVEWB39|NOICONPOS|SAVEINFO
  753.                         ON|OFF
  754.   Commandtemplate:      IMAGEONLY/S,DROPACTIVE/S,SAVEWB39/S,NOICONPOS/S,
  755.                         SAVEINFO/S,ON/S
  756.   Function:             Switch an Option on or off
  757.   Description:          The  named  Option will be set, if the switch ON is
  758.                         set.
  759.  
  760.  
  761.  
  762. 2.3.4.5 register
  763.         --------
  764.  
  765.   Format:               REGISTER <Register> <Value>
  766.   Commandtemplate:      REGISTER/N/A,VALUE/N/A
  767.   Function:             Set a register to a value.
  768.   Description:          Similar    to   selecting   a   value   using   the
  769.                         ColorSwap-List.  Defines the   register  Value  the
  770.                         register Register is transferred to.
  771.  
  772.  
  773.  
  774. 2.3.5 Errors
  775.       ------
  776.  
  777.   Since Workbench 2.0 there are very different kinds of Icons.  For example
  778. the  AppIcons,  which need not to be real physical Icons.  You can't change
  779. any  valueof  thosekind  of  icons.   If  you place an Icon of this kind as
  780. Destination- or Source-Icon, an error-message will appear.
  781.  
  782.   If an error-message appears it should be clear what happens.  But in case
  783. of problems using MuiReIcon send me a description of the problem and I will
  784. try to help.  My address can be found at the end of this Documentation.
  785.  
  786.   There  is  one  error  I  want  to  mention.  It appears when dropping an
  787. Drawer-,   Disk-   or   Trashcan-Icon   onto  the  Source-Field,  where  no
  788. corresponding  File  respectively  Directory  exists  to.  In this case the
  789. program  only  gets  an  empty App-Message from the OS, and cannot find any
  790. icon.
  791.  
  792.  
  793.  
  794. 3.1 Copyright
  795.     ---------
  796.  
  797.   MuiReIcon  is  MAILWARE,  i.e.,  if  you  want  to use this program after
  798. testing it for a few days, you have to send me a message.  This message can
  799. be  a  normal  letter (snail-mail), a postcard or electronic mail (e-mail).
  800. If you want to note something to the program, please do, the future of this
  801. program  depends on replies.  I will try to answer as fast as possible, but
  802. remember  I'm no software-house, so I have to keep my costs low and I don't
  803. spend all my time on it.  :o)
  804.   My Address can be found at the end of this documentation.
  805.  
  806.  
  807.             MuiReIcon is © Copyright by Stefan Schulz in 1993/94
  808.  
  809.  
  810.  
  811.   For building this program the following products were used:
  812.  
  813. o M2Amiga Modula 2
  814.   © Copyright 1992 by A+L AG, Däderiz 61, 2540 Grenchen
  815.  
  816. o CygnusEd Prof. Release 2.12
  817.   © Copyright 1987/88/89/90 by CygnusSoft Software
  818.  
  819. o Magic-User-Interface Version 2.0
  820.   © Copyright 1993/94 by Stefan Stuntz
  821.  
  822.  
  823.   Trademarks:
  824.  
  825. o Amiga, AmigaDOS and Workbench are registered trademarks of
  826.   Commodore Amiga Inc.
  827.  
  828.  
  829.  
  830. 3.2 Redistribution
  831.     --------------
  832.  
  833.   MuiReIcon  has  to  be  distributed as it comes.  The Package must not be
  834. changed  in  any  way.   There must not be any profit selling this Package!
  835. For  distributing  it you can use every usual media, like floppy-disks, CD,
  836. hard-disks, networks etc.
  837.  
  838.   When  including  this  program  in a public-domain-serie please send me a
  839. message.  May be there's already a new version of this program so you don't
  840. include old stuff.
  841.  
  842.   Comercial  Distribution  of  this  program  is  only allowed with written
  843. permission by the Author.
  844.  
  845.  
  846.  
  847.  
  848. 3.3 DISCLAIMER
  849.     ----------
  850.  
  851.   THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE  EXTENT PERMITTED BY
  852. APPLICABLE  LAW.   EXCEPT  WHEN  OTHERWISE  STATED IN WRITING THE COPYRIGHT
  853. HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF
  854. ANY  KIND,  EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
  855. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  856. THE  ENTIRE  RISK  AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH
  857. YOU.   SHOULD  THE  PROGRAM  PROVE  DEFECTIVE,  YOU  ASSUME THE COST OF ALL
  858. NECESSARY SERVICING, REPAIR OR CORRECTION.
  859.  
  860.   IN  NO  EVENT  UNLESS  REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  861. WILL  ANY  COPYRIGHT  HOLDER,  OR  ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  862. PROGRAM  AS  PERMITTED  ABOVE,  BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  863. GENERAL,  SPECIAL,  INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  864. USE  OR  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  865. DATA  OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  866. PARTIES  OR  A  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
  867. EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
  868. SUCH DAMAGES.
  869.  
  870.  
  871.  
  872.  
  873.  
  874. 3.4 MUI
  875.     ---
  876.  
  877.                           This application uses
  878.  
  879.  
  880.                         MUI - MagicUserInterface
  881.  
  882.                   (c) Copyright 1993 by Stefan Stuntz
  883.  
  884.  
  885. MUI is a system to generate and maintain graphical user interfaces. With
  886. the  aid  of  a  preferences program, the user of an application has the
  887. ability to customize the outfit according to his personal taste.
  888.  
  889. MUI is distributed as shareware. To obtain a complete package containing
  890. lots of examples and more information about registration please look for
  891. a  file  called "muiXX.lha" (XX means the latest version number) on your
  892. local bulletin boards or on public domain disks.
  893.  
  894.           If you want to register directly, feel free to send
  895.  
  896.  
  897.                          DM 20.-  or  US$ 15.-
  898.  
  899.                                   to
  900.  
  901.                              Stefan Stuntz
  902.                         Eduard-Spranger-Straße 7
  903.                              80935 München
  904.                                 GERMANY
  905.  
  906.  
  907.  
  908.  
  909. 4.1 History
  910.     -------
  911.  
  912.   Revision V2.21
  913.   --------------
  914.   created on Wednesday, 04.05.94 by Stefan Schulz
  915.     - removed ugly Bug which caused tooltypes not being kept
  916.     - changed register-handling, so colors are correct even with os3-icons
  917.     - changed Source-Field-Background, smaller Dest-Field
  918.     - removed Bug loading icons via menu didn't work selecting .info-files
  919.   
  920.   Revision V2.20
  921.   --------------
  922.   created on Wednesday, 27.04.94 by Stefan Schulz
  923.     - changed image-handling (custom MUI-Class)
  924.     - changed icon-handling (now more clean)
  925.     - removed bug occurred by saving OS3-Icons
  926.     - changed swap-source handling, now just a test. To save use Option!
  927.     - new menu-item for saving as default-Icon
  928.     - now saves 3-Planes-Icons if OS3-Option not chosen (4-Plane-Icons
  929.       will be cloned)
  930.     - handles input of default-icons too
  931.  
  932.   Revision V2.16
  933.   --------------
  934.   created on Thursday, 23.03.94 by Stefan Schulz
  935.     - new Register-Member Information
  936.     - Source-Code-Decluttering
  937.   
  938.   Revision V2.15
  939.   --------------
  940.   created on Friday, 11.03.94 by Stefan Schulz
  941.     - removed little bug caused exchanging last two tooltype-entries on
  942.       de-/activation
  943.     - changed mode-group to styleguide-conform look
  944.     - added ARexx-Port (Cmds for SourceHook, DestHook, Options, Register,
  945.       Working-Mode)
  946.  
  947.   Revision V2.14
  948.   --------------
  949.   created on Friday, 25.02.94 by Stefan Schulz
  950.     - No Colorswap-Window anymore, Register-Class ColorSwap and ToolTypes
  951.       instead
  952.     - Now only Image and ColorSwap exclude each other
  953.     - New Function for swapping SourceIcon-Colors
  954.     - Color-Presets added to Window-Menu
  955.     - Remembers Sourcename correct now
  956.   
  957.   Revision V2.13
  958.   --------------
  959.   created on Thursday, 24.02.94 by Stefan Schulz
  960.     - New Option No Icon-Position
  961.     - New Menu-Functions: Open Icon, Save Icon, Load Options, Save Options
  962.     - Fixed another little Bug
  963.  
  964.   Revision V2.12
  965.   --------------
  966.   created on Monday, 21.02.94 by Stefan Schulz
  967.     - GUI for BitPlane-ColorSwap added
  968.     - Little Bugfix with Pathnames
  969.     - Now able to save WB 3.x Icons
  970.     - "Save as..." added
  971.  
  972.   Revision V2.11
  973.   --------------
  974.   created on Thursday, 18.11.93 by Stefan Schulz
  975.     - Function BitPlanes replaced with ColorSwap, allows to swap Colors
  976.       of the Icon
  977.  
  978.   Revision V2.1
  979.   --------------
  980.   created on Tuesday, 19.10.93 by Stefan Schulz
  981.     - added placement-buttons for Tooltypelist
  982.     - now source-icons can also be dropped at defaulttool-, kind- and
  983.       tooltype-Group for only getting these values
  984.     - no iconwindow anymore. sourceicon shown in the window itself
  985.  
  986.   Revision V2.0
  987.   --------------
  988.   created on Thursday, 07.10.93 by Stefan Schulz
  989.     - MUI-Version ( GUI-only-version )
  990.  
  991.   Revision V1.2
  992.   --------------
  993.   created on Friday, 27.09.93 by Stefan Schulz
  994.     - total rewritten Source-Code
  995.  
  996.   Revision V1.1
  997.   --------------
  998.   created on Friday, 12.06.92 by Stefan Schulz
  999.     - new option for changing the Kind of Icons added
  1000.  
  1001.   Revision V1.0
  1002.   --------------
  1003.   created on Saturday, 06.06.92 by Stefan Schulz
  1004.     --- Initial release ---
  1005.  
  1006.  
  1007.  
  1008.  
  1009. 4.2 Acknowledgements
  1010.     ----------------
  1011.  
  1012.   Here I want to send thanks to those who helped me direct or indirect with
  1013. developing this Program and/or supported me technical or mental.
  1014.  
  1015.         - Catherine
  1016.  
  1017.                 For  the best moral support i ever got in my live, so I did
  1018.                 not think about computers only.
  1019.  
  1020.         - Stefan "stunzi" Stuntz
  1021.  
  1022.                 His  Magic-User-Interface pushed me to program this.  Using
  1023.                 MUI makes programming Interfaces being fun.
  1024.  
  1025.         - Christoph "pepo" Feck
  1026.                 
  1027.                 For Beta-Testing and many (too many) wishes ;o)
  1028.  
  1029.         - Frank Grimm
  1030.                 
  1031.                 For Beta-Testing and good advices
  1032.  
  1033.         - Christian "Kochtopf" Scholz
  1034.  
  1035.                 For  his  fast changings to the MUI-Interface for M2, so it
  1036.                 is as nice as I wanted it to be ;o)
  1037.  
  1038.         - Kai "kaib" Bolay
  1039.                 
  1040.                 For a beta-version of his program, which helped me to solve
  1041.                 some problems.
  1042.  
  1043.   For good advices and helpful comments:
  1044.   
  1045.         Robert Poole, Thorsten "mjoelnir" Stolpmann, Mark "theMug" Rose,
  1046.         Markus Stipp, Thomas Witt, Olav Mueller
  1047.  
  1048.   All you, mates, supporting Mailware :o)
  1049.  
  1050.   And, especially to you, using this program.
  1051.  
  1052.  
  1053.  
  1054.  
  1055. 4.3 Updates
  1056.     -------
  1057.  
  1058.   The latest Version of MuiReIcon should be found on aminet. If a PD-Serie
  1059. includes it (and tells me) you can also get it there. If there's no other
  1060. possibility you can get it from me too, whereby I want to have no costs, of
  1061. course. So, if you want me to send it to you, send me an EMPTY floppy-disk
  1062. AND the money to send it back to you.
  1063.  
  1064.  
  1065.  
  1066. 4.4 Support
  1067.     -------
  1068.  
  1069.   Please, send all errors you found, remarks to the program, questions or
  1070. anything else you want (except explosives and illegal stuff), but at least
  1071. the "I use it"-Message, to:
  1072.  
  1073.  
  1074.                               Stefan Schulz
  1075.                        Alte Neusser Landstraße 230
  1076.                                50769  Köln
  1077.                                  Germany
  1078.  
  1079.   Or using e-mail (Internet) to:
  1080.                        schulz@informatik.uni-kl.de
  1081.  
  1082.   Or via IRC:
  1083.                                Nick: Steffel
  1084.                Frequently on channel #Amiga and/or #AmigaGer
  1085.  
  1086.  
  1087.